home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / g5108b.zip / G5.ZIP / TEXT / HELP.TXT < prev    next >
Text File  |  1996-06-17  |  27KB  |  446 lines
  1.  
  2.                               ──══ Galaxy 5 ══──
  3.                                 Help With Doors
  4.  
  5.  
  6.      ────────────────────────────────────────────────────────────────────
  7.       This file explains how to setup a door, and the use of fossil
  8.       drivers, and related topics. It is primarily for those who are not
  9.       yet familiar with the setup of doors on their BBS (new SysOps). If
  10.       you already know how to setup doors, then you do not need to read
  11.       this file. It starts from the basics of door setup.
  12.      ────────────────────────────────────────────────────────────────────
  13.       Please keep in mind that I run a Wildcat! 4 system, and will be
  14.       giving many examples using the Wildcat! doors setup. If you are
  15.       running BBS software other than Wildcat!, then setup points
  16.       referred to in this file, may differ slightly, or greatly.
  17.      ────────────────────────────────────────────────────────────────────
  18.  
  19.  
  20.                                   DOOR SETUP
  21.      ────────────────────────────────────────────────────────────────────
  22.       When you first install a door, you should read any documentation
  23.       on the setup of that particular door. Most doors are similiar in
  24.       setup, but alot have their own requirements on setting up.
  25.       Sometimes door authors will include a SYSOP.DOC file with their
  26.       door. This file usually contains everything you need to know on
  27.       how to setup the door. If there is no SYSOP.DOC file, look for
  28.       one or more of these files,
  29.                                  SYSOP.TXT
  30.                                  README.TXT
  31.                                  READ1ST.TXT
  32.                                  README.1ST
  33.                                  INSTALL.TXT
  34.                                  INSTALL.DOC
  35.                                  SETUP.DOC
  36.                                  SETUP.TXT
  37.       If you see any of these files (especially the README files), you
  38.       should refer to them immediately before attempting to install the
  39.       door. If none of the above files are included, then look for a
  40.       .DOC or .TXT file with the same name as the door. Such as
  41.       GALAXY5.DOC for Galaxy 5.
  42.      ────────────────────────────────────────────────────────────────────
  43.       First, if necessary, run the setup program that comes with the
  44.       door (or any install programs needed, or both if necessary). If
  45.       you need to edit a .CFG file, then do that also. In some setup
  46.       programs, and/or .CFG files, you will be asked where the door can
  47.       find your BBS drop file. Drop files have different names for
  48.       different BBS platforms, and some use the same drop files. Here is
  49.       a list of a few of them,
  50.                               DOOR.SYS
  51.                               DORINFO*.DEF
  52.                               CALLINFO.BBS
  53.                               PCBOARD.SYS
  54.                               SFDOORS.DAT
  55.       Among many others. Many new SysOps ask the common question, "I
  56.       don't have a DOOR.SYS file! Where is mine?" Or whatever drop file
  57.       your BBS uses. The answer is simple, there isn't one! These files
  58.       are temporary files created when a user uses a door on your BBS.
  59.       The door then reads this drop file to gather caller information
  60.       such as name, security level, time left on BBS, COM port info,
  61.       etc. After the door exits, and your BBS returns, the drop file is
  62.       erased. So you will not see a door drop file at any given time,
  63.       unless you are in another "window" in a multi-tasking environment,
  64.       looking in the drop file directory while a caller is using a door.
  65.      ────────────────────────────────────────────────────────────────────
  66.       Sometimes the door configuration will ask for your drop file type.
  67.       This is where you either use the file name of the drop file your
  68.       BBS creates, or a special abbreviation or other code the door uses
  69.       for each different type of drop file (the config file or setup
  70.       program will usually inform you of the code to use if any). Then
  71.       you may be asked for the directory where to find this drop file. A
  72.       Wildcat! single node system would use the C:\WILDCAT\WCWORK\NODE1
  73.       directory (replacing C:\WILDCAT with your home Wildcat!
  74.       directory). And sometimes the door configuration will ask for the
  75.       full path and file name of the drop file. A Wildcat! single node
  76.       system would use, C:\WILDCAT\WCWORK\NODE1\DOOR.SYS (again
  77.       replacing the C:\WILDCAT with your home Wildcat! directory).
  78.      ────────────────────────────────────────────────────────────────────
  79.  
  80.  
  81.                          SETTING UP THE BATCH FILE(S)
  82.      ────────────────────────────────────────────────────────────────────
  83.       The most important thing you probably need to look for, in the
  84.       documentation, is how to set up the batch file(s) for the door.
  85.       The batch file(s) to run the door, are ran from your BBS software.
  86.       In a Wildcat! 4 setup, these batch files have the .BAT extension,
  87.       and are placed in the WILDCAT\BATCH subdirectory. Here is a basic
  88.       example of a batch file used to run a door when the BBS is setup
  89.       to "shell" to doors instead of terminating (the recommended
  90.       setting),
  91.                @ECHO OFF
  92.                D:
  93.                CD\DOORS\DOORNAME
  94.                DOORNAME FILENAME.CFG
  95.  
  96.        Here are explanations of each command
  97.       ---------------------------------------
  98.       @ECHO OFF - This turns of echoing these commands to your screen.
  99.                   It is not really a necessary command, but is used by
  100.                   many SysOps (including myself!).
  101.  
  102.       D:        - This is only needed if your doors are located on a
  103.                   different drive than your BBS software. It will change
  104.                   to that drive before executing the door.
  105.  
  106.       CD\DOORS\DOORNAME - Changes to the directory containing the door
  107.                           about to be executed. Most of the time, this
  108.                           is necessary for the door program to be able
  109.                           to find its program files. If you use a
  110.                           command like,
  111.                           D:\DOORS\DOORNAME\DOORNAME.EXE FILENAME.CFG,
  112.                           then if the door needs to use any external
  113.                           program files, it will not be able to find
  114.                           them, because you are actually running the
  115.                           door from your drop file directory this way,
  116.                           instead of the doors own directory.
  117.  
  118.       DOORNAME FILENAME.CFG - Executes the door using the configuration
  119.                               file as the command line (if needed). Here
  120.                               is where door batch files usually get
  121.                               tricky. Many doors use many different
  122.                               command line parameters (the command line
  123.                               parameter in this case is the FILENAME.CFG
  124.                               command) to initiate the door. You will
  125.                               have to find out what command line
  126.                               parameters you need to use to execute each
  127.                               door from your BBS batch file, in one of
  128.                               the documentation files explained earlier.
  129.                               Most doors need the name of the config
  130.                               file as the only parameter, but this is
  131.                               not always the case, so you really should
  132.                               look at the docs to find out what
  133.                               parameters you need to use.
  134.      ────────────────────────────────────────────────────────────────────
  135.       Case is not important in your batch file(s). Upper or lower case
  136.       can be used anywhere in the above commands.
  137.      ────────────────────────────────────────────────────────────────────
  138.       Sometimes you will need to change back to your drop file directory
  139.       after the door is run (if